IRIX Base Documentation 2001 May/SGI IRIX Base Documentation 2001 May.iso/usr/share/catman/p_man/cat3/ifl_c/iflConfig.z/iflConfig

Text File | 1998-10-30 | 7.0 KB | 199 lines

iiiiffffllllCCCCoooonnnnffffiiiigggg((((3333))))      IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll       iiiiffffllllCCCCoooonnnnffffiiiigggg((((3333))))



NNNNAAAAMMMMEEEE
     iiiiffffllllCCCCoooonnnnffffiiiigggg - class for pixel abstraction

IIIINNNNHHHHEEEERRRRIIIITTTTSSSS FFFFRRRROOOOMMMM
     This is a base class and therefore has no inheritance.

HHHHEEEEAAAADDDDEEEERRRR FFFFIIIILLLLEEEE
     #include <ifl/iflCdefs.h>

CCCCLLLLAAAASSSSSSSS DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The iflConfig class is used to describe the configuration of pixel data.
     It is used in iflFile functions such as iiiiffffllllGGGGeeeettttTTTTiiiilllleeee(((()))) and iiiiffffllllSSSSeeeettttTTTTiiiilllleeee(((()))) to
     describe the configuration of data in the user's buffer.

     An iflConfig contains six public member variables describing a collection
     of pixels:


          iiiiffffllllTTTTyyyyppppeeee _d_t_y_p_e               Data type of the pixels

          iiiiffffllllOOOOrrrrddddeeeerrrr _o_r_d_e_r              Order of the pixels

          iiiiffffllllOOOOrrrriiiieeeennnnttttaaaattttiiiioooonnnn _o_r_i_e_n_t_a_t_i_o_n  Orientation of the pixels

          iiiinnnntttt _n_c_h_a_n_s                  Number of data channels the pixels
                                      contain

          iiiinnnntttt _c_h_o_f_f                   Offset in the channel list for the
                                      purpose of mapping from one collection
                                      of channels to another.

          iiiinnnntttt**** _c_h_a_n_n_e_l_s               List that maps channels from one
                                      collection to another.  This array is
                                      not maintained by this object, the data
                                      pointed to must persist while the object
                                      is in use.



















                                                                        PPPPaaaaggggeeee 1111






iiiiffffllllCCCCoooonnnnffffiiiigggg((((3333))))      IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll       iiiiffffllllCCCCoooonnnnffffiiiigggg((((3333))))



     UUUUssssiiiinnnngggg iiiiffffllllCCCCoooonnnnffffiiiigggg

     The iflConfig object contains a list that maps channels from one
     collection to another.  In this code fragment,

          unsigned char buffer[10*10*3];
          static int list[] = { 2, 1, 0 };
          iflConfig cfg(iflUChar, iflInterleaved, 3, list);

          someFile.getTile(0, 0, 0, 10, 10, 1, buffer, &cfg);

     _c_f_g is used to indicate that _b_u_f_f_e_r is going to receive a 10-by-10 array
     of three-component  pixels stored in interleaved order with an unsigned
     char data type.  This would override the actual configuration of the data
     in _s_o_m_e_F_i_l_e.

     The channel list provides the buffer's channel information. The first
     channel of the buffer receives data from channel 2 of _s_o_m_e_F_i_l_e. The
     second channel is from _s_o_m_e_F_i_l_e's channel 1. The third buffer channel
     gets channel 0 of _s_o_m_e_F_i_l_e.  In general, when an iflConfig is defaulted,
     the operation being performed assumes that the source and destination
     configurations match.  If _s_o_m_e_F_i_l_e was actually a four-channel float
     image stored in separate order, then

          someFile.getTile(0, 0, 0, 10, 10, 1, buffer);


     would require a buffer declared as

          float buffer[10*10*4];

     and would receive a verbatim copy of the requested section of _s_o_m_e_F_i_l_e.

CCCCLLLLAAAASSSSSSSS MMMMEEEEMMMMBBBBEEEERRRR FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN SSSSUUUUMMMMMMMMAAAARRRRYYYY
     CCCCoooonnnnssssttttrrrruuuuccccttttoooorrrr

          iflConfig* iflConfigCreate(iflDataType type, iflOrder ord,
                                     int nchan, int* chanList,
                                     int chanOff, iflOrientation ori(0))


     DDDDeeeessssttttrrrruuuuccccttttoooorrrr

          void iflConfigDelete(iflConfig *img)











                                                                        PPPPaaaaggggeeee 2222






iiiiffffllllCCCCoooonnnnffffiiiigggg((((3333))))      IIIImmmmaaaaggggeeee FFFFoooorrrrmmmmaaaatttt LLLLiiiibbbbrrrraaaarrrryyyy CCCC++++++++ RRRReeeeffffeeeerrrreeeennnncccceeee MMMMaaaannnnuuuuaaaallll       iiiiffffllllCCCCoooonnnnffffiiiigggg((((3333))))



FFFFUUUUNNNNCCCCTTTTIIIIOOOONNNN DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNNSSSS
     iiiiffffllllCCCCoooonnnnffffiiiigggg(((())))

          iflConfig* iflConfigCreate(iflDataType type, iflOrder ord,
                                     int nchan, int* chanList,
                                     int chanOff, iflOrientation ori(0))


          The constructor creates an iflConfig with data type, _t_y_p_e; data
          ordering, _o_r_d_e_r; and channel list defined by _c_h_a_n_L_i_s_t of
          _n_c channels.  If _c_h_a_n_L_i_s_t is omitted, all _n_c_h_a_n channels are used in
          ascending order.  Optionally, the orientation is set to _o_r_i.  If
          omitted, the orientation matches that of the image being accessed.

     iiiiffffllllCCCCoooonnnnffffiiiiggggDDDDeeeelllleeeetttteeee(((())))

          void iflConfigDelete(iflConfig *img)


          Deletes an object of class iflConfig, thus freeing any associated
          resources.

SSSSEEEEEEEE AAAALLLLSSSSOOOO
     iflFile































                                                                        PPPPaaaaggggeeee 3333